package com.pond.pond.service;

import java.util.Map;

/**
 * 钓技学堂统计分析Service接口
 * 
 * @author pond
 * @date 2024-01-15
 */
public interface IFishingTechniqueStatsService 
{
    /**
     * 获取统计概览数据
     * 
     * @return 统计概览数据
     */
    public Map<String, Object> getStatsOverview();

    /**
     * 获取文章阅读趋势
     * 
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 阅读趋势数据
     */
    public Map<String, Object> getReadTrend(String startDate, String endDate);

    /**
     * 获取分类统计
     * 
     * @return 分类统计数据
     */
    public Map<String, Object> getCategoryStats();

    /**
     * 获取热门文章排行
     * 
     * @param type 排序类型：read-阅读量，like-点赞数，comment-评论数
     * @param limit 数量限制
     * @return 热门文章数据
     */
    public Map<String, Object> getPopularArticles(String type, Integer limit);

    /**
     * 获取用户活跃度统计
     * 
     * @param days 统计天数
     * @return 用户活跃度数据
     */
    public Map<String, Object> getUserActivityStats(Integer days);

    /**
     * 获取评论统计
     * 
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 评论统计数据
     */
    public Map<String, Object> getCommentStats(String startDate, String endDate);
}